C/C++ 3D Game Tools

home *** CD-ROM | disk | FTP | other *** search

/ C/C++ 3D Game Tools / C-C++ 3D Game Tools.iso / ziptools / arj / av305.arj / BRUCE305.DOC < prev next >

Wrap

Text File | 1993-05-19 | 16.4 KB | 362 lines

BRUCE305.DOC 05/19/93 This documentation provides some overview information on a number of utilities that have been posted by Wayne Software. All programs described herein were written by Bruce Guthrie. Most are distributed with a Wayne Software copyright. Others were written for the U.S. Department of Commerce. All are free for use provided relevant documentation is kept with the programs, no changes are made to the programs or documentation, and they are not bundled with commercial programs or charged for separately. READ (but not READMAKE and READINIT) and CONVERT are excluded from the commercial packaging restriction. People who need to bundle AV, BFIND, DIRTOTAL, FILL, MULTICOL, NETSORT, or READWK in commercial packages other than shareware/freeware collections must pay a $50 registration fee to "Wayne Software" at the following address. Comments and suggestions can also be sent to: Bruce Guthrie Wayne Software 113 Sheffield St. Silver Spring, MD 20910 fax: (301) 588-8986 The utilities are uploaded with a ZIP name that includes the year and month of the release. These names are: AVymm.ZIP AV program BFINDymm.ZIP BFIND program CHANGymm.ZIP CHANGE program CONCTymm.ZIP CONCAT program CONVRymm.ZIP CONVERT program DIRTOymm.ZIP DIRTOTAL program FILLymm.ZIP FILL program FILUPymm.ZIP FILUPDAT program FIXCHymm.ZIP FIXCHARS program MULCOymm.ZIP MULTICOL program NETSOymm.ZIP NETSORT program READymm.ZIP READ program (with READINIT and READMAKE) READWyym.ZIP READWK program (with READINIT) This collection of utilities were compiled using Microsoft's VisualBASIC for DOS 1.0 compilers. In each case, Thomas G. Hanlin III's excellent PBClone routines provided additional functionality. Each of the utilities are separately described in a like-named *.DOC file. This documentation (BRUCEymm.DOC--the file release date is indicated by the "ymm" parameter) serves to summarize what the various utilities consist of. Several of the routines have defaults that can be changed by the program CONFIGWS.EXE which is included in the appropriate ZIP's. Wayne Software also writes programs, batch files, and sets up menu systems for people on a for-fee basis. If you desire this service, contact Wayne Software at the address specified above. -------------------------------------------------------------------------------- A summary of each routine follows. See the associated *.DOC files for fuller explanations: AV.EXE: Archive directory viewer. Presents list of files in archive (ZIP, ARC, etc) and lets you sort as desired. Syntax: AV filespec [ /-P | /P ] [ /Ox | /O-x ] [ /? ] BFIND.EXE: Allows Boolean-type FIND requests. For example, find any line with one string AND another one, or any line with one string OR another. The syntax shown below is limited since "search" allows a lot of choices. BFIND [ /V | /-V ] [ /C | /-C ] [ /N | /-N ] [ /I | /-I ] [ /P | /-P ] [ /-HEADER | /HEADER ] { search } infile [ /? ] [ >filename ] CHANGE.EXE: Processes change commands in files. Files can be of any size and type (e.g. binary or text) and are processed quickly. Up to twenty-five change commands can be processed in a single pass. Also provides ability to remove trailing spaces from text files. Syntax: CHANGE filename [ commandfile | /FROM string /TO string [ /IN search ] ] [ /LINES { line1-line2 | line1 linect } ... ] [ /V | /-V ] [ /I | /-I ] [ /Noutfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] ] [ /Fflag_file ] [ /Ttemp_file ] [ /TRIM | /-TRIM ] [ /BINARY | /TEXT ] [ /VERIFY | /-VERIFY ] [ /Q ] [ /? ] CONCAT.EXE: Concatenates a series of files together. Can use wildcards or an input file. Syntax: CONCAT [ filespec | @filespec | [drive:]filespec+ ] outfile [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] [ BINARY | /TEXT [ /CRLF ] ] [ /LRECL=nnn [ /BLKSIZE=nnnn ] ] [ /NAMED ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ] CONFIGWS.EXE: Lets you change some of the defaults for some of the programs. Syntax: CONFIGWS [ routine ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ] CONVERT.EXE: Converts between data formats: FROM dBase, ASCII-delimited (commas between fields and quotes around strings), and fixed field TO Lotus WKS, ASCII-delimited, dBase, and fixed field. Syntax: CONVERT infile [ outfile [ deffile ] ] [ /OVERWRITE | /-OVERWRITE | /APPEND | /OVERASK ] [ /DEF=deffile ] [ /FROM { FIXED | ASCII | ASCII=char | DBF } ] [ /FIXED | /ASCII | /ASCII=char | /DBF ] [ /USEDEF | /NODEF ] [ /TO { FIXED | ASCII | ASCII=char | WKS | DBF } ] [ /HEADER | /-HEADER ] [ /SKIP | /MISSING | /ABORT ] [ /SAS ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ] DIRTOTAL.EXE: Prepares report showing files in subdirectory or drive. Allows some restriction requests (show only files with date greater than a certain value). Similar to Norton's FF and Ray Van Tassle's WIZ command (which is a great program but it doesn't work on network or CD-ROM discs) in some ways but presents a more formal report. Syntax: DIRTOTAL [ [ drive: ] ... [drive:][filespec] | [ drive: ] ... [drive:]\path[\filespec] ] [ /NL ] [ /S { GT | GE | LT | LE | EQ | NE } value ] [ /D { GT | GE | LT | LE | EQ | NE } mm/dd/yy ] [ /ATTR=attr ] [ /Ffilename ] [ /SPLIT ] [ /SUB | /-SUB ] [ /Z ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ] FILL.EXE: Program designed to fill up floppies with the maximum number of files that will fit into them. "FILL *.BAS" will move *.BAS files onto a floppy, taking the biggest files first. When it can't fit a file, it will skip it and move the next one. Syntax: FILL [ source-filespec ] [ dest-drive: | dest-drive:\path\ ] [ /MOVE | /COPY ] [ /OVERWRITE | /-OVERWRITE | /OVERSKIP | /OVERASK ] [ /PROMPT | /-PROMPT ] [ /Ox | /O-x ] [ /Xfilespec ]... [ /WIPE | /-WIPE ] [ /MULTI | /SINGLE ] [ /BEEP | /-BEEP ] [ /Q ] [ /? ] FILUPDAT.EXE: Program which compares a selected list of files in a source path against those in another path and copies those that have been updated. Similar to DOS' REPLACE command but works from a stored list of files and can handle any number of directories. Syntax: FILUPDAT control_fil [ /Flist_file [ /OVERWRITE | /APPEND | /-OVERWRITE | /OVERASK ] ] [ /FULL ] [ /ALL ] [ /Q ] [ /? ] FIXCHARS.EXE: Program which removes non-standard print characters from a text file. Translates graphics characters into their ASCII equivalents. Also expands tabs and removes backspaces. Is primarily intended for people who have problems printing a file. Syntax: FIXCHARS infile { outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] | /REPLACE } [ /BINARY | /TEXT ] [ /Ffilename ] [ /-EJECT ] [ /Q ] [ /? ] MULTICOL.EXE: Program creates multiple column listings from straight ASCII text, ASCII-delimited text, or dBase files. Also does subtotalling. Syntax: MULTICOL infile outfile [ /OVERWRITE | /-OVERWRITE | /OVERASK ] [ /DELIM="string" ] [ /LINES=n ] [ /WIDTH=n ] [ /EJECT | /-EJECT ] [ /COLUMNS=n ] [ /WRAP | /-WRAP [ /INDENT=n ] | /REFLOW ] [ /Ccontrol_file ] [ /SETUP="string" ] [ /RESET="string" ] [ /{ TITLE | HEADER | FOOTER }[ R | C | L ][ 1 to 5]="text" ] [ /{ TITLE | HEADER | FOOTER }{ T | B }="string" ] [ /FROM ASCII | /FROM ASCII=char | /FROM DBF ] [ /DEF=deffile ] [ /SKIP | /MISSING | /ABORT ] [ /GAP=n ] [ /USEDEF ] [ /TALLY ] [ /SUM={ col_spec | var_spec } ] [ /BREAK={ col_spec | var_spec } ] [ /PRINT={ col_spec | var_spec } ] [ /? ] NETSORT.EXE: Slow but effective method for sorting files on a Banyan (and possibly other) server. Syntax: NETSORT [ path ] [ /S ] [ /Ox | /O-x ] [ /BEEP | /-BEEP ] [ /? ] READ.EXE: Simplified version of a file browser. Only works with files of 16,000 lines or less (maybe 800,000 bytes). Other text viewers are out there. This one has some advantage because it's free. Syntax: READ [ filename ] [ /line ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /Pport ] [ /-I ] [ /? ] READINIT.EXE: Creates and maintains the READ.INI file which may be used by READ.EXE, READWK.EXE and any self-viewable file created by READMAKE.EXE. Syntax: READINIT [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /-I ] [ /? ] READMAKE.EXE: Program which takes an ASCII-text file and makes it self-viewable. Provides same capabilities as the READ program. Syntax: READMAKE infile [ outfile ] [ /OVERWRITE | /-OVERWRITE | /OVERASK ] [ /DATE=FILE | /DATE=TODAY ] [ /TITLE="text" ] [ /? ] READWK.EXE: Program to view Lotus worksheets (WKS and WK1 only at this point; anyone know the forms for WK3?). Limited to 2500 cells. Syntax: READWK [ filespec | @filename ] [ /row ] [ /Pport ] [ /-I ] [ /MONO | /-MONO | /COLOR | /-COLOR ] [ /? ] ------------------------------------------------------------------------------- If you can't get all of the utilities from your own sources, send $10 to the address above and I'll send you everything. Another Wayne Software product, called The DEMO System, is released as a shareware program. The DEMO System is a unique system designed to create text-screen demos, tutorials, help screens, etc. Look for the file DEMOSymm.ZIP. ================================Revision history================================ Detailed revision history is only maintained for the last two or three releases. After that, you get the summaries only. No one reads this junk anyway, right? Programmer types like to put in it in just to justify what they've been doing over the last couple of years. -------------------------------------------------------------------------------- Release 93/05: This release presented a number of problems for me. For one thing, my main employer claimed that all of the programs that I was writing at home were in fact their's because I'm a government programmer and the programs could be used at work. This was an interesting move given that I had done all the work at home and was donating them to the office and was only keeping the copyright and rights to the source code. It took two agonizing weeks for the department's copyright attorney to say my boss was wrong. In any case, it forced me to reexamine how much free time I'll spend doing Commerce work (and means I'll actually ask for comp time instead of working 60 hours a week for them for the hell of it) and also made me reduce my offerings and redefine what was completely Wayne Software's (by virtue of having been programmed exclusively at home) and what was shared. As a result, three routines--ADD, DIRCOMP, and TAKE1ST--were dropped entirely from the suite of utilities I'll be distributing. Four routines--CHANGE, CONCAT, FILUPDAT, and FIXCHARS--while developed and maintained primarily on personal time, were switched from Wayne Software ownership to U.S. Department of Commerce ownership and documentation was adjusted appropriately. In addition to that, my favorite cat--Lucy--died on May 5 after a sudden illness which didn't help my spirits either. I added two routines bringing the total number of routines to 13. * NETSORT: Slow but effective program to sort files on a Banyan (and possibly other) server. * READWK: This is a freebie program for viewing Lotus 1-2-3 worksheets. If anyone has the specs for Lotus WK3 files, please send them off to me so I can support that too. ADD: Dropped. See above. AV: Switched the program so it automatically detects if redirection is being used. If so, switches default to /-P instead of /P. DIRCOMP: Dropped. See above. TAKE1ST: Dropped. See above. -------------------------------------------------------------------------------- Release 93/04: Several bugs were fixed in The DEMO System, READ, and AV. Nothing new over the 93/03 releases which weren't distributed much (I hope). READ: Added the ability to provide an input file list using the "@filename" parameter. This lets you specify multiple files to be processed that can't be handled by a simple wildcard specification. READMAKE: Made "Text file viewer" the default title. -------------------------------------------------------------------------------- Release 93/03: This was a buggy release that went up on one BBS but not on the Internet. Usually, I'm making all sorts of changes at the last minute, trying to make an end of month deadline for posting on the Internet. In the rush, I found I had uploaded an older infinite loop version of The DEMO System Then I found I had incompletely tested the new printer-initialization stuff in READ. I uploaded a couple of patched files (under the names READX303.ZIP and DEMOS303.ZIP) but felt that all of this pushing that I was doing to myself was counterproductive. The changes in The DEMO System had been pretty major and left me without as much debugging time as I really needed. After the two botched programs, I decided to not release a 93/03 version to Internet and wait a week or two and put out a more tested 93/04 version instead. Added one routine this time--AV which is similar to Vern Buerg's FV program but is free, views archive directories in page mode (so you can flip up and down), and lets you change the file date to be the date of the most recent member. Added a new routine--READINIT--to the READymm.ZIP file. This one creates a READ.INI file for you, primarily for setting up printer attributes. CONCAT: Added /-OVERWRITE and /OVERASK options. CONVERT: Added /APPEND option which only works for ASCII-delimited or fixed- field output files. DIRCOMP: Recoding using VisualBASIC for DOS. Externally, nothing changed except for using VBDOS's ISAM program to avoid the need for an external sort program at all. This resulted in the dropping of the /SORT=pgm parameter. DIRTOTAL: Recoded using VisualBASIC for DOS. Externally, nothing changed except for using VBDOS's ISAM program to avoid the need for an external sort program at all. This resulted in the dropping of the /SORT=pgm, /DOS, and /-DOS parameters. MULTICOL: Fixed bug occuring when you had a numeric field that you skipped on output. Switched ASCII character representation to be /nnn to be more generic and to fit in with the changes in the READ program. "/27" should be recoded as "/027". Programmed it so imbedded page eject characters would work in any file that uses the /-WRAP option. READ: Switched to VBDOS for this one (for better or worse), added support for printers via the READ.INI file, and added a /-I switch to ignore same. Added secondary program READINIT.EXE which manages the READ.INI file. -------------------------------------------------------------------------------- Release 93/02: CHANGE, CONVERT, DIRCOMP, FILL, FILUPDAT, FIXCHARS, MULTICOL, READMAKE, and TAKE1ST: Added /OVERWRITE, /OVERASK, /-OVERWRITE, and /OVERPROMPT where appropriate. FILL: Added /COPY and /MULTI features. -------------------------------------------------------------------------------- Release 93/01: First release posted on SIMTEL (Internet). New: The DEMO System (shareware and not part of normal package). -------------------------------------------------------------------------------- Release 92/12: Major changes: MULTICOL adds ASCII-delimited and dBase support. -------------------------------------------------------------------------------- Release 92/11: BRUCEymm.ZIP idea ends; utilities released separately now. New: MULTICOL and READMAKE. -------------------------------------------------------------------------------- Release BRUCE210.ZIP: New: BFIND and CONFIGWS (called BGCONFIG then). -------------------------------------------------------------------------------- Release BRUCE208.ZIP: New: FIXCHARS. -------------------------------------------------------------------------------- Release BRUCE205.ZIP: DIRTOTAL supports MS-DOS 5.0 and can avoid external sorting program. -------------------------------------------------------------------------------- Release BRUCE204.ZIP: Initial release. ADD, CHANGE, CONCAT, CONVERT, DIRCOMP, DIRTOTAL, FILL, FILUPDAT, READ, and TAKE1ST.